home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / systems / web2c / unixtex.ftp < prev    next >
INI File  |  1994-10-26  |  9KB  |  238 lines
  1. [unixtex.ftp: 27 October 1994]
  2.  
  3. The master version of this file is on ftp.cs.umb.edu [158.121.104.33]
  4. in pub/tex/unixtex.ftp. Mail kb@cs.umb.edu with comments or questions.
  5.  
  6. =========================================================================
  7.              Consider joining the TeX Users Group (TUG):
  8.   support the maintenance and development of the programs you retrieve.
  9.               Send membership request to: tug@tug.org.
  10. =========================================================================
  11.  
  12.             FTP INSTRUCTIONS
  13.  
  14. ... for Unix sites wanting to install (plain) TeX, LaTeX, BibTeX, plain
  15. Metafont, an X window system previewer, a PostScript device driver, and
  16. an HP LaserJet device driver.
  17.  
  18. Use the host nearest you:
  19.  
  20.     Host            Internet address    TeX root dir
  21.     ----            ----------------    ------------
  22.     ftp.shsu.edu        192.92.115.10        tex-archive
  23.     ftp.tex.ac.uk        134.151.44.19        tex-archive
  24.     ftp.dante.de        128.69.1.12        tex-archive
  25.     
  26.     For additional hosts, see /README.mirrors on these sites or
  27.     finger ctan_us@ftp.shsu.edu.
  28.  
  29. All the CTAN hosts have these files:
  30.     /README.archive-features
  31.     /README.site-commands 
  32. Our instructions assume you have read these.
  33.  
  34. If you do not have GNU's gunzip utility, first retrieve and install the
  35. gzip package.  Set "binary" mode by typing "bi" at your ftp prompt; retrieve
  36.  
  37.     /tex-archive/tools/info-zip/gzip-<version>.tar
  38.  
  39. gzip does a better job of compression than standard Unix compress, and
  40. it is (as far as is known) patent-free.  It is illegal to use Unix
  41. compress (in the USA), because it infringes a software patent.  Write to
  42. the League for Programming Freedom <lpf@uunet.uu.net> for information
  43. about fighting the new software monopolies in the US.
  44.  
  45.  
  46. Retrieving a basic set of input files and fonts:
  47. -----------------------------------------------
  48.  
  49. ftp> cd tex-archive/systems/web2c
  50. ftp> bi
  51. ftp> get lib.tar.gz
  52.  
  53.      This file contains a minimal collection of fonts (TFM files only),
  54.      (La)TeX macros, MF macros, and BibTeX files -- enough to get
  55.      started. The AMS fonts and macros are included.
  56.      
  57.      lib.tar.gz unpacks into a directory named `texmf', which you will
  58.      want in your equivalent of /usr/local/lib -- whatever you will
  59.      define as your $(datadir) in the Makefiles.
  60.  
  61.      The organization of the archive was debated at great length. We hope
  62.      it will be useful. If you don't like our organization, feel free to
  63.      move the files around as you see fit, not forgetting to redefine the
  64.      search paths and installation directories. The Makefiles,
  65.      kpathsea/HIER, kpathsea/paths.h.in, and web2c/README (``Directory
  66.      hierarchies'') have more information.
  67.  
  68.      You must decide on your directory structure *before* doing the
  69.      compilations, since you must specify default search paths, and
  70.      since the web2c Makefile tries to create the basic .fmt and .base
  71.      files, which require the .{tex,mf,tfm} input files to be in place.
  72.  
  73.  
  74. Retrieving web2c (that is, TeX, Metafont, and friends):
  75. ------------------------------------------------------
  76.  
  77. Still in tex-archive/systems/web2c:
  78.  
  79. ftp> get web.tar.gz    [Knuth's WEB sources for TeX, MF, & family:
  80.              unpacks into ./web2c-<version>]
  81. ftp> get web2c.tar.gz    [WEB-to-C source: also unpacks into ./web2c-<version>]
  82.  
  83.      You *must* retrieve and unpack *both* web.tar.gz and web2c.tar.gz.
  84.      
  85.  
  86. Retrieving device drivers:
  87. -------------------------
  88.  
  89.        For an X window system previewer (xdvik):
  90. ftp> cd /tex-archive/dviware/xdvik
  91. ftp> get xdvik.tar.gz    [unpacks into ./xdvik-<version>]
  92.  
  93.        For a DVI-to-PostScript translator (dvipsk):
  94. ftp> cd /tex-archive/dviware/dvipsk
  95. ftp> get dvipsk.tar.gz    [unpacks into ./dvipsk-<version>]
  96.  
  97.        For a DVI-to-PCL translator (dviljk):
  98. ftp> cd /tex-archive/dviware/dviljk
  99. ftp> get dviljk.tar.gz    [unpacks into ./dviljk-<version>]
  100.  
  101.       [optional] For prebuilt bitmaps:
  102. ftp> cd /tex-archive/fonts/cm/pk
  103. ftp> get pk300.zip
  104.      These bitmapped fonts were generated by Metafont using the cx
  105.      mode_def for write-black 300dpi devices.
  106.  
  107.      If using the default search paths, place this set of 
  108.      Computer Modern fonts in $(fontdir)/public/cm/pk/cx.
  109.  
  110.      The zip/unzip package is in /tex-archive/tools/info-zip.  At least
  111.      version 5.x is necessary.
  112.  
  113. ftp> quit        [end ftp session]
  114.  
  115.  
  116. Compilation and installation:
  117. ----------------------------
  118.  
  119. Each of these packages -- web2c, xdvik, dvipsk, dviljk -- contains its
  120. own installation instructions.  It is possible to build all the programs
  121. in a single make, but it is simpler to make them separately.
  122.  
  123. Compile web2c first (i.e.,, the material in both web.tar.gz and
  124. web2c.tar.gz, unpacked).  Begin by reading
  125.  
  126.     ./web2c-<version>/README
  127.     ./web2c-<version>/web2c/README
  128.     ./web2c-<version>/web2c/INSTALL
  129.     ./web2c-<version>/kpathsea/README
  130.     ./web2c-<version>/kpathsea/INSTALL
  131.  
  132. The INSTALL files are your guides to installation.
  133. At the simplest, you just do configure; make; make install at the top-level.
  134.  
  135. Remember to set up your texmf directory hierarchy before embarking on 
  136. your compilation (see "For a basic set of input files and fonts" above).
  137.  
  138. All installation processes require careful attention to detail, and
  139. knowledge of your system.  Festa lente -- make haste slowly -- and you
  140. improve your chances of success.
  141.  
  142.  
  143. ftp.cs.umb.edu:pub/tex/*.help describe some common problems with the
  144. current version of web2c. (I am working on the next release as hard as I
  145. can, really.)
  146.  
  147. -- Contrary to what the web2c installation instructions imply, you must use
  148.     configure --prefix=/your/tex/root
  149. instead of editing the prefix in the Makefile(s). (Editing does work in
  150. some cases, but not all.)
  151.  
  152. -- configure does not always guess the type of yytext properly; the
  153. symptom will be compiler errors involving yytext. Replace the line
  154. `DECLARE_YYTEXT' in web2c-6.1/web2c/web2c.h with the right thing. See
  155. web2c.yytext.help.
  156.  
  157. -- If the compiler complains about something involving foil_x_wchar_t, try
  158.     make CFLAGS="-g -DNO_FOIL_X_WCHAR_T"  (for web2c); or
  159.     make CFLAGS="-g -DFOIL_X_WCHAR_T" (for everything else).
  160.  
  161. -- I messed up and declared alloca in web2c/web2c/web2c.h. Just delete
  162. the declaration. ftp.cs.umb.edu:pub/tex/web2c.alloca.help does this.
  163.  
  164. -- make clean removes *.pool in web2c/tex and web2c/mf. Use make
  165. distclean or make mostlyclean instead. Or edit tex/Makefile and
  166. mf/Makefile to remove *.pool at distclean instead of clean.
  167. ftp.cs.umb.edu:pub/tex/web2c.pool.help does this.
  168.  
  169. -- The kpathsea that comes with web2c is an older version (1.6) of
  170. what is in the other distributions (2.x). The file
  171. web2c.kpathsea-<version>.help will make web2c work with the given
  172. version of kpathsea.
  173.  
  174.  
  175. Further help:
  176. ------------
  177.  
  178. The tex-archive/help and tex-archive/info directories on the CTAN sites
  179. have much additional documentation on all aspects of TeX.
  180.  
  181.  
  182. Distribution on tape and CD/ROM:
  183. -------------------------------
  184.  
  185. For TeX on a single tape (4mm DAT or QIC-24), ordering information is
  186. available from unixtex@u.washington.edu.  A distribution fee in the area
  187. of US$210.00 covers administrative costs.  Tapes will be available at
  188. least through summer of 1994.
  189.  
  190. The Free Software Foundation distributes the minimal TeX system
  191. described here on CD/ROM. Write gnu@prep.ai.mit.edu for ordering info.
  192.  
  193. Other organizations also have TeX on a CD/ROM, but I do not know the
  194. details to include them here. Tell me if you have more info.
  195.  
  196.  
  197. Retrieving TeX executables:
  198. --------------------------
  199.  
  200. (Original from George D. Greenwade <bed_gdg@SHSU.edu>, but slightly edited.)
  201.  
  202. The files in /tex-archive/systems/unix/unixkit/ are minimal sets of
  203. precompiled executables (thanks to Sebastian Rahtz for making these sets
  204. available) for the various platforms using the latest web2c (version
  205. 6.1) package and techniques outlined in unixtex.ftp.  The one exception to
  206. this is the file share.tar.gz, which includes man pages and pool files
  207. for the distribution which may be used across all architectures.
  208.  
  209. Specifically excluded from this distribution in unixkit are the many
  210. additional macros and styles, fonts, and utilities which are available
  211. elsewhere in the CTAN archives -- the idea is to have the ability to get
  212. the latest files, but still have them in workable chunks for retrieval
  213. purposes. [Retrieve lib.tar.gz as discussed above for the minimal
  214. font/macro files.]
  215.  
  216. You *must* use the default location, /usr/local/lib/texmf, for your TeX
  217. macros, fonts, etc. if you use these binaries.  If you cannot use that
  218. directory, then retrieve the sources and recompile.
  219.  
  220. If you get these binaries, you do not need to get web.tar.gz and web2c.tar.gz.
  221.  
  222.  
  223. Acknowledgements:
  224. ----------------
  225.  
  226. The three main sites listed above are part of the Comprehensive TeX Archive 
  227. Network (CTAN) --  the result of cooperative work among members of TUG, 
  228. DANTE [German-speaking TeX Users Group], and UKTUG [U.K. TeX Users Group], 
  229. under the leadership of George Greenwade, Chair for TUG's Technical 
  230. Working Group on TeX Archive Guidelines.
  231.  
  232. Special thanks to George Greenwade for establishing the CTAN site at 
  233. Sam Houston State University (US); to Rainer Schoepf, Barbara Burr, 
  234. and members of DANTE for the CTAN site in Heidelberg (Germany); and to 
  235. Sebastian Rahtz for the CTAN site in Cambridge (UK).
  236.  
  237. This file was conceived and created by Elizabeth Tachikawa.
  238.